home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CD ROM Paradise Collection 4
/
CD ROM Paradise Collection 4 1995 Nov.iso
/
edit
/
thedjg20.zip
/
dos.hlp
< prev
next >
Wrap
Text File
|
1995-01-26
|
20KB
|
551 lines
/***********************************************************************/
/* (dos) Help file for The Hessling Editor 2.0 */
/***********************************************************************/
Command-line invocation:
the [-h?nmrs] [-p profile] [-a profile_arg] [-w width] [[dir] [file [...]]]
Where:
-h or -? Display usage information and version.
-n Do not execute a profile file.
-m Force display into mono, ignoring colour support.
-r Run THE in read-only mode.
-s A debugging aid for Unix versions. Turns off signal trapping.
-p profile The name of the profile file to use. If not specified,
the file "PROFILE.THE" will be used, unless overridden
by the environment variable "THE".
-a prof-arg Used to pass a string to the profile file as argument.
Only works with REXX macros.
-w width Length of longest line THE can handle (default 2048)
dir Will display a directory of the specified dir.
file [..] Specifications of file(s) to edit. If multiple files
are specified, each will be put in a separate file in
the ring. The first one specified will be displayed.
If no files are specified, the current directory will
be displayed.
Issuing [SOS EDIT] on a file spec will edit that file.
[SOS EDIT] on a subdir will display that directory.
Option flags must be specified in LOWER case.
Environment variables used:
--------------------------
See Appendix 1 of the.man
Notes:
- The capitalised portion of a command is the minimum abbreviation
for the command.
- UP, DOWN, NEXT differ from XEDIT and Kedit in that they do not
accept numerical arguments abutted to the command name.
Thus "N3" is not supported.
THE Commands:
-------------
Add [n]
add blank line
ALL [rtarget]
select and display restricted set of lines
BAckward [n|*]
scroll backwards [n] screens
BOTtom
move to the bottom of the file
CANcel
quit from all unaltered files in the ring
CCancel
qquit from all files in the ring
Change /string1/string2/ [target] [n] [m]
change one string to another
cmatch
find matching bracket character
CMSG [text]
display text on command line
COMMAND command [options]
execute a command without translation
control_char
allow control characters to be entered
COPY target1 target2
COPY BLOCK [RESET]
copies text from one position to another
CURsor Screen UP|DOWN|LEFT|RIGHT
CURsor Screen row [col]
CURsor [Escreen] UP|DOWN
CURsor [Escreen|Kedit] LEFT|RIGHT
CURsor [Escreen] row [col]
CURsor CMdline [n]
CURsor HOME [SAVE]
move cursor to specified position
DEFine key-name [command [args] [[#command [args]...]]]
assign one or many commands to a key
DELete [target]
delete lines from a file
DIRectory [filespec]
list the specified directory as an editable file
DOS [command]
execute an operating system command
DOSNowait command
execute an operating system command - no prompt
DOSQuiet command
execute an operating system command quietly
Down [relative_target]
move forward in the file a number of lines
DUPlicate [n [target|BLOCK]]
duplicate lines
Edit [filename]
edit another file or switch to next file
EMSG [message]
display message
enter
execute a command
EXPand [target]
expand tab characters to spaces
EXTract /item/[...]
obtain various internal information about THE
FFile [filename]
force a FILE of the current file to disk
FILE [filename]
write the current file to disk and remove from ring
FILLbox [c]
fill the marked box block with a character
FOrward [n]
scroll forwards [n] screens
GET [fileid]
insert into file the contents of specified file
HELP
edit help file for THE
Input [line contents]
insert the command line contents into the file
Join [ALigned]
join a line with the line following
LEft [n|HALF]
scroll the screen to the left
[Locate] target [command]
search for a target
LOWercase [target]
change uppercase characters to lowercase
LS [filespec]
list the specified directory as an editable file
MACRO filename [arguments]
execute a macro command file
MARK Line|Box|Stream|Word|Column
mark a portion of text
MODify set-command
display current SET command for alteration
MOVE BLOCK [RESET]
move a portion of text
MSG [message]
display message on error line
Next [relative_target]
move forward in the file a number of lines
NEXTWindow
switch focus of editing session to other window
NOMSG command [parameters]
execute a command suppressing any messages
NOP
no operation command
OS [command]
execute an operating system command
OSNowait command
execute an operating system command - no prompt
OSQuiet command
execute an operating system command quietly
OVERLAYBox
overlay marked box block on current cursor position
PRint [target] [n]
PRint LINE [text]
PRint STRING [text]
PRint FORMfeed
PRint CLOSE
send text to default printer or print spooler
PUT [target] [fileid]
write part of a file to another
PUTD [target] [fileid]
write part of a file to another and delete
QQuit
exit from the current file without saving changes
Query item
display various option settings
QUIT
exit from the current file if no changes made
READV Cmdline|KEY
read keystrokes and pass to macro
RECover [n|*]
recover changed or deleted lines
REDRAW
redraw the current screen
REFRESH
refresh the contents of the current screen
REPEat [target]
repeat the last command
Replace [text]
replace the current line with supplied text
RESet ALL|Block|Prefix
cancel the marked block or prefix commands or both
RGTLEFT [n]
scroll the screen to the left or right
RIght [n|HALF]
scroll the screen to the right
SAVE [fileid]
save changes to current file
SCHange /string1/string2/ [target] [n] [m]
selectively change strings
SET set_command [set_command parameter(s) ...]
execute various set commands
SHift Left|Right [n] [target]
move text left or right
SHOWKey
display current key value and command assignation
SORT target [[[Ascending|Descending] left_col right_col] [...]]
sort selected lines in a file
SOS sos_command [sos_command ...]
execute various sos commands
SPlit [ALigned]
split a line into two lines
spltjoin
split/join two lines
SSave [fileid]
force SAVE to specified file
STATus [filename]
display current settings of various variables
SUSPend
suspend THE and return to operating system
tabpre
switch between FILEAREA and PREFIX area
TEXT text
simulate keyboard entry of characters
THE [filename]
edit another file or switch to next file
TOP
move to the top of the file
Up [relative_target]
move backward in the file a number of lines
UPPercase [target]
change lowercase characters to uppercase
Xedit [filename]
edit another file or switch to next file
?[+]
return the next/prior command on the command line
=
re-execute the last command issued on the command line
! [command]
execute an operating system command
SET commands
------------
[SET] ARBchar ON|OFF [char1] [char2]
set arbitrary character(s) for targets
[SET] AUtosave n|OFF
set autosave period
[SET] BACKup OFF|TEMP|KEEP|ON
indicate if a backup copy of the file is to be kept
[SET] BEEP ON|OFF
turn on or off the audible alarm when displaying errors
[SET] CASE Mixed|Lower|Upper [Respect|Ignore] [Respect|Ignore]
[Respect|Ignore]
set case sensitivity parameters
[SET] CLEARScreen ON|OFF
indicate if the screen is to be cleared on exit
[SET] CLOCK ON|OFF
turn on or off display of time on status line
[SET] CMDArrows Retrieve|Tab
sets the behaviour of the up and down arrow keys
[SET] CMDline ON|OFF|Top|Bottom
sets the position of the command line.
[SET] COLOUR area [modifier[...]] [foreground background]
[SET] COLOR area [modifier[...]] [foreground background]
set colours for display
[SET] COMPat The|Xedit|Kedit
set compatibility mode
[SET] CURLine M[+n|-n] | [+|-]n
set position of current line on screen
[SET] DIRInclude *
[SET] DIRInclude [Normal] [Readonly] [System] [Hidden] [Directory]
set the file mask for directory command
[SET] DISPlay n [m|*]
specify which level of lines to display
[SET] EOLout CRLF|LF
set end of line terminating character(s)
[SET] ETMODE ON|OFF
indicate if extended display mode is possible
[SET] HEX ON|OFF
set how hexidecimal strings are treated in string operands
[SET] HEXDISPlay ON|OFF
turn on or off display of character under cursor
[SET] HEXShow ON|OFF [M[+n|-n]|[+|-]n]
turn on or off hex display of current line
[SET] IDline ON|OFF
specify if IDLINE is displayed
[SET] IMPcmscp ON|OFF
set implied operating system command processing
[SET] IMPMACro ON|OFF
set implied macro command processing
[SET] IMPOS ON|OFF
set implied operating system command processing
[SET] INSERTMode ON|OFF|TOGGLE
put editor into or out of insert mode
[SET] LINENd ON|OFF [char]
allow/disallow multiple commands on command line
[SET] MACROExt [ext]
set default macro extension value
[SET] MACROPath path[s]
set default path for macro commands
[SET] MARgins left right [[+|-]indent]
set left and right margins for wordwrap
[SET] MSGLine ON [M[+n|-n]|[+|-]n] [lines]
set position and size of message line
[SET] MSGMode ON|OFF
set display of messages on or off
[SET] NEWLines Aligned|Left
set position of cursor after adding blank line
[SET] NONDisp char
specify character to display for non-displaying characters
[SET] NUMber ON|OFF
turn prefix numbers on or off
[SET] PENDing ON string
[SET] PENDing OFF
[SET] PENDing BLOCK string
set status of pending prefix commands
[SET] Point .name [OFF]
assign a name to the current line
[SET] POSition ON|OFF
determine if LINE/COL is displayed on IDLINE
[SET] PREfix ON [Left|Right]
[SET] PREfix Nulls [Left|Right]
[SET] PREfix OFF
[SET] PREfix Synonym newname oldname
set prefix area attributes
[SET] PRINTER spooler
define printer spooler name
[SET] REPROFile ON|OFF
indicate if profile file to be executed for all files
[SET] RESERved +|-n [colour] text|OFF
display a reserved line
[SET] REXXOUTput File|Display n
indicate where REXX output is to go
[SET] SCALE ON|OFF [M[+n|-n]|[+|-]n]
set position and status of scale line on screen
[SET] SCOPE All|Display
sets which lines are to be excluded from commands
[SET] SCReen n [Horizontal|Vertical]
specifiy number of screens displayed
[SET] SELect [+|-]n [target]
sets the selection level for the specified lines
[SET] SHADOW ON|OFF
determines if shadow lines are displayed or not
[SET] STATUSLine Top|Bottom|Off|GUI
set position of status line
[SET] STAY ON|OFF
set condition of cursor position after CHANGE/LOCATE commands
[SET] SYNonym ON|OFF
[SET] SYNonym [LINEND char] newname [n] oldname
define synonyms for commands
[SET] TABKey Tab|Character Tab|Character
set characteristics of the SOS TABF command
[SET] TABLine ON|OFF [M[+n|-n]|[+|-]n]
set position and status of tab line on screen
[SET] TABS n1 n2[n3...n32]
[SET] TABS INCR n
set tab length for TAB key
[SET] TABSIn ON|OFF [n]
set tab processing on file input
[SET] TABSOut ON|OFF [n]
set tab processing on file output
[SET] TYPEAhead ON|OFF
set behavior of screen redraw
[SET] Verify first [last]
set column display limits
[SET] WORDWrap ON|OFF
set wordwrap feature on or off
[SET] Zone first [last]
set column limits for editing
SOS commands
------------
SOS ADDline
add blank line after focus line
SOS BOTTOMEdge
move cursor to bottom edge of FILEAREA
SOS CURRent
move cursor to current line
SOS CURSORAdj
move first non-blank character to cursor
SOS DELBAck
delete the character to the left of the cursor
SOS DELChar
delete character under cursor
SOS DELEnd
delete to end of line
SOS DELLine
delete focus line
SOS DELWord
delete word at or right of cursor
SOS DOPREfix
execute any pending prefix commands
SOS EDIT
edit a file from directory list
SOS ENDChar
move cursor to end of focus line
SOS EXecute
move cursor to command line and execute command
SOS FIRSTCHar
move cursor to first non-blank of field
SOS FIRSTCOl
move cursor to first column of field
SOS LASTCOl
move cursor to last column of field
SOS LEFTEdge
move cursor to left edge of window
SOS LINEAdd
add blank line after focus line
SOS LINEDel
delete focus line
SOS MAKECURR
make focus line the current line
SOS MARGINL
move cursor to the left margin column
SOS MARGINR
move cursor to the right margin column
SOS PARINDent
move cursor to the paragraph indent column
SOS PREfix
move cursor to leftmost edge of prefix area
SOS QCmnd
move cursor to command line and clear
SOS RIGHTEdge
move cursor to right edge of window
SOS STARTENDChar
move cursor to end/start of focus line
SOS TABB
move cursor to previous tab stop
SOS TABf
move cursor to next tab stop
SOS TABFIELDB
move cursor to previous enterable field
SOS TABFIELDf
move cursor to next enterable field
SOS TABWORDB
move cursor to beginning of previous word
SOS TABWORDf
move cursor to start of next word
SOS TOPEdge
move cursor to top edge of filearea
SOS UNDO
undo changes to the current line
THE prefix commands:
-------------------
a - add blank line
i
/ - make line current line
c - copy line
m - move line
d - delete line
x - exclude line
" - duplicate line
s - show excluded lines
p - target for c and m - prior to line
f - target for c and m - following line
> - shift line right
< - shift line left
cc - copy line block
mm - move line block
dd - delete line block
xx - exclude line block
"" - duplicate line block
>> - shift line block right
<< - shift line block left
.xxxxx - give name to line
TABL - display tab line
SCALE - display scale line
THE Line Targets:
----------------
Absolute target: An absolute line number.
eg. :12 - line number 12
All target: All lines in file the file.
eg. ALL
Blank target: The first line containing only blank characters.
eg. BLANK
Block target: All lines in the marked block.
eg. BLOCK
Named line target: A line with a name, set with [SET] POINT
eg. .fred
Relative target: A target relative to the current line.
eg. 12 - 12 lines below the current line
-4 - 4 lines above the current line
* - all lines below the current line
-* - all lines above the current line
String target: A sequence of characters between delimiters.
eg. /string/ - the first line below the
current line containing "string"
-/string/ - the first line above the
current line containing "string"
Targets may be separated by the boolean operators '&' or '|'.
eg. /string1/ | /string2/
Targets may also be prefixed with '~' to signify boolean NOT.
eg. ~/string/
Default Key Assignments:
------------------------
The first column is the name of the key in its normal state. Shifted
keys have a 'S-' prefix, control keys have a 'C-' prefix and Alt keys
have a 'A-' prefix. Thus key names for F1 are: F1,S-F1,C-F1 and A-F1.
The key names are the same as displayed by the showkeys command.
---------+-------------------+-----------+--------------+-------------
Key Name | Normal | Shifted | Control | Alt
---------+-------------------+-----------+--------------+-------------
F1 | help | locate | |
F2 | nextwindow | | |
F3 | file | qquit | |
F4 | sos addline 1 | | |
F5 | sos makecurr | | |
F6 | | | |
F7 | cmatch | | |
F8 | recover | | |
F9 | sos delline 1 | | |
F10 | spltjoin | | |
F11 | | | point .a |
F12 | control_char | | locate .a |
CURU | up_arrow | | |
CURD | down_arrow | | |
CURL | left_arrow | | sos tabwordb |
CURR | right_arrow | | sos tabwordf |
INS | insertmode toggle | | |
DEL | sos delchar | | |
HOME | tabcmd | | |
END | sos startendchar | | sos delend |
PGUP | backward 1 | | top |
PGDN | forward 1 | | forward * |
BKSP | sos delback | | |
ENTER | enter | | |
PLUS | tabpre | | |
NUMENTER | sos doprefix | | |
ESC | sos undo | | |
TAB | sos tabf | sos tabb | |
A | | | sos cursoradj|
B | | | | mark box
C | | | | copy block reset
D | | | | duplicate 1 block
F | | | | fillbox
G | | | | delete block
J | | | | join aligned
K | | | | copy block
L | | | | mark line
M | | | | move block reset
O | | | | overlaybox
R | | | redraw |
S | | | | split aligned
U | | | | reset block
W | | | | sos delword
X | | | | sos edit
Z | | | suspend |
---------+-------------------+-----------+--------------+-------------